SUDS Brewer's database and log Welcome to SUDS, the brewers database and log program. This program provides a single place to put all of your recipes, log entries and miscellaneous brewing comments. Provided is a full featured multi-windowing editor, a formatted log entry system, Hop IBU spreadsheet, calendar, calculator, label printer and a host of other features. ) Press ESC to put this help screen away. Calculator The calculator is a simple four-function calculator with add, subtract, multiply, and divide. To operate the calculator you can either use the keyboard or press the buttons on the calculator with the mouse. The 'C' key clears the calculator, the ' ' key will erases the last character typed, and the ' ' key toggles the value from positive to negative (the keyboard equivalent of ' ' is '_'). Calendar The calendar displays the current month, highlighting todays date. The next and previous months can be viewed using the '+' or '-' keys respectivly. The mouse can also be used to change the month by pressing the icons. About When you choose the About command from the File menu, a dialog box appears, showing copyright and version information. G To close the box, press Esc, Space, or Enter, or click the OK button. File (Alt-F) The file menu offers the following options: X Creating recipe Changing existing recipes Reading recipe ASCII Saving recipes entries Saving recipe ASCII Deleting recipes entries Open recipe Change directories Print recipe Display information about Shell Exit SUDS New Recipe (Alt-N) Selecting New Recipe from the main menu or pressing Alt-N will open a new recipe editing window to enter new recipe text. See also: Recipe Window Editor Commands Window commands Get Template (Alt-T) Selecting the Get Template option from the main menu or pressing Alt-T will display a selection list of "Template" recipes available in the SUDS database. Any of the selected recipes can be selected using the mouse or keyboard and an untitled recipe window will be displayed with the template text. This provides you with a good start for a particular recipe style from which to create your recipe. 3 Templates in the selection box will be displayed in alphabetic order Pressing any keyboard letter(s) will position you automatically to the first selection starting with the letter(s) keyed. Clicking (or tabbing) to the OK button will select the highlighted recipe as will double-clicking with the mouse. See also: Recipe Window 4 Editor Commands Window commands Get Recipe (F3) Selecting the Get Recipe option from the main menu or pressing the F3 key will display a selection list of existing recipes in the SUDS database. Any of the displayed recipes can be selected using the mouse or keyboard and is then displayed in a window for further editing. Recipes in the selection box will be displayed in order of the recipe category (ie Pale Ale) or in raw alphabetic order depending on the option selected from the Sort Order selection under Options on the main menu. Pressing any keyboard letter(s) will position you automatically to the first selection starting with the letter(s) keyed. Clicking (or tabbing) to the OK button will select the highlighted recipe as will double-clicking with the mouse. x If a filter is active, an UnFilter button will also be displayed. Pressing this button will clear the current filter. See also: Recipe Window U Editor Commands Window commands Filtering Recipes Filtering SUDS Recipes The Filter function from the Search menu allows you to limit the recipes shown in the Get Recipe window based on search parameters that you specify. When your recipe list gets into the hundreds (which it will if you use my utility to add Cat's Meow files - SUDSCM!), this can greatly reduce time spent searching recipes. The Filter dialog box allows you to limit recipes shown by their Category, Method, minimum and maximum gravities or alcohol content and by text contained within the recipe. For all options except recipe text, only recipes meeting ALL of the criteria are selected. For recipe text searches, you may enter one search phrase per line. If ANY one of the search phrases is found within the recipe, it is selected (providing that it meets all other non-text search criteria). Its a good idea to limit the search as much as possible with non-text fields since text searches are more time consuming. Once the search has been performed, the recipe selection list shows only recipes meeting the filter options specified. The filter remains in effect until you end the program, press the Cancel button or press the Unfilter button from the Get Recipe dialog box. Recipe Window Any number of recipe and log windows can be open at one time (limited only by available memory). The first 9 windows open will have a window number assigned (1-9). X Pressing Alt and the window number will take you directly to the corresponding window. r Within the recipe window you may type any text or paste text into the window that was cut from any other window. When you complete the recipe text, selecting Save or pressing F2 will allow you to save the recipe into the SUDS database. Selecting Export recipe file will allow you to save the text to an ascii file. Selection Screens Often during your SUDS session, you will need to select Recipes or log entries from a list box. The list box contains a list of recipes or log entries, an OK button and a Cancel button. q To select the highlighted item, either double-click on a displayed item with the mouse, or press the OK button. The arrow keys or the page up/down keys will navigate through the list. You can also click on the scroll bar with the mouse to move through the entries. k Keying any letter from the keyboard will position you at the first entry beginning with the letter keyed. Save... (F2) Selecting the Save option from the file menu or pressing F2 will do one of two things. r If the currently selected window is a log window, the information will be saved or updated in the SUDS database. If the currently selected window is a recipe window, the Suds Recipe Details window will be displayed where you will confirm or enter further recipe information which will then be saved or updated in the SUDS database. Recipe Details The SUDS Recipe details screen is displayed whenever you are saving or updating recipe details in the SUDS database. This screen allows you to enter or change the Recipe Name, Recipe Category (ie Pale Ale, Stout, etc.), Recipe method (Extract, Mash, etc.), starting and finishing gravities, quantity and ageing time. c The Category and Extract fields both allow you to either key in a value or select a value from a list. To display the list while in these fields either click on the down arrow icon on the screen with the mouse or press the down arrow key on the keyboard. This displays a values list. To select a value, either double-click on the value or press enter. } Pressing the OK button will save or update the recipe in the SUDS database. Pressing Cancel will return you to the editor. Delete Selecting Delete from the file menu will allow you to delete a recipe or log entry. If the currently selected window is a log or recipe window, you will be prompted to confirm the deletion. Selecting Yes will then delete the current recipe or log entry and close that window. If no windows are opened, a recipe selection list is displayed to select a recipe to delete. Selecting a recipe will bring up the confirmation screen. Selecting Yes will then delete the recipe. Read Recipe from ASCII File The Open File option from the file menu displays a Open a File dialog box. This option would be used to open a recipe text file in ascii format allowing you to save the recipe in your personal SUDS database. & The Open File dialog box contains: an input box with a history list a list box to browse the directory the standard Cancel button Open action button an information panel that describes the selected file Save to File The Save recipe to file option from the main menu will allow you to save the currently open recipe to an ASCII file. This allows you to create stan- dard files for printing or uploading to other brewers. You could also use this option to export a SUDS recipe allowing you to edit the recipe with any other editor or word processor besides the integrated SUDS editor. Open Log Alt-L Selecting the open log option from the file menu will allow you to add or select a log entry for further editing. The log list will show log entries for the current recipe window if any is active. Otherwise the full log for all recipes will be listed in descending date order. Double-clicking on an entry or pressing the OK button will bring up the Log Window for the log entry. Log Window The log window is where you will make most of your notes relating to a particular batch of beer. The information captured includes date started, date bottled, starting gravity, finishing gravity, Hop IBU rating and free-form notes. The date fields allow you to enter a date or jump forward or backward by a day when pressing "+" or "-". Clicking the right mouse button while on a date field will display a calendar for the current month. Clicking the right mouse button or selecting the Hop IBU worksheet option from the Tools menu will display the Hop worksheet which will calculate the Hop IBUs for your beer batch. Most of your information will go into the free-form note area (your "notebook"). This area allows all editing commands just like the recipe editor does. See also : Editor Commands Print (Alt-P) Selecting the print option from the file menu or pressing Alt-P when a recipe or log window is open allows you to print the recipe and/or log entry. Each type of window in SUDS will react differently to the print option. If the window is a recipe from the SUDS database, you will be shown a Print Recipe dialog box. If the window is a file that hasn't been saved in the SUDS database, you'll receive a confirmation message to print the current file with the options, Yes, No or Cancel. Selecting the Yes button will print the file. t For a log window, a confirmation message will also be displayed. Selecting Yes will print the current log entry. Print Recipe Dialog Box When printing a recipe from the SUDS database, the Print Recipe dialog box is displayed. Here you can specify whether or not the Recipe text, recipe stats (gravities, etc) and log entries are to be printed for the recipe. These options are selected by clicking on the selection boxes with the mouse, or by tabbing to the selection box and pressing "X" or spacebar. Hop IBUs Hop IBUs (International Bittering Units) are a worldwide standard of bitterness measurement based on hop isomerization (how readily the alpha acids are converted to iso-alpha acids) and the percentage of alpha acids contained in the hops used. DOS Shell With the DOS Shell command, you can leave the program temporarily to perform a DOS command or run another program. 9 To return to this program, type EXIT at the DOS prompt. Exit (Alt-X) The Exit command terminates this program. Edit (Alt-E) The Edit menu offers the following options: | Undo previous change block Copy block Paste block Show Clipboard Clear Undo Selecting undo from the Edit menu will undo the last change you made within the integrated SUDS editor. See also : Editor Commands Cut (Shift-Del) After marking a block of text with the mouse or keyboard block command, selecting Cut from the Edit menu or pressing Shift-Del will remove the block from the editor and put the block into the Clipboard from where it may be pasted into another location or window. See also : Editor Commands Copy (Ctrl-Del) After marking a block of text with the mouse or keyboard block command, selecting Copy from the Edit menu or pressing Ctrl-Del will copy the block from the editor into the Clipboard from where it may be pastedinto another location or window. See also : Editor Commands Copy (Shift-Ins) Once a block of text has been cut or copied into the clipboard, selecting paste from the Edit menu or pressing Shift-Ins will copy the text from the clipboard into the current location within the current window. See also : Editor Commands Show Clipboard Selecting the show clipboard option from the edit menu will show the current contents of the SUDS clipboard. The clipboard is used to transfer text to and from windows. See also : Editor Commands Clear Selecting the clear option from the edit menu will clear the contents of the currently selected window. See also : Editor Commands Search (Alt-S) The Search menu offers the following options: A Find Search replace Search again Find text Selecting the find option from the Search menu will display the find window which allows you to specify the text to search for, whether or not the search should be text sensitive and whether or not the search should be limited to whole words only. Pressing the down arrow key or selecting the down-arrow icon will display the previous text search strings that you entered and will allow you to select any of these. The Case sensitive and Whole words only options will toggle on and off when you click on them with the mouse or press the space bar when they are focused. Replace text Selecting the replace option from the search menu will display the replace window which allows you to specify the text to be replaced, the text to replace it with, whether or not the search is case sensitive, whether or not the search is limited to whole words, whether or not you should be prompted for each replace and whether or not all found text should be replaced. The text to find field allows you to enter text to search for. Pressing the down arrow key or clicking on the down arrow icon will display a pick-list of previous search strings. u The New text field allows you to specify the text to replace the found text above. This also has a pick-list icon. Search Again Selecting the Search Again option from the search menu will repeat the last search command that you entered. Options (Alt-O) The Options menu offers the following options: Sort Order recipe lists Pack database Export recipes Import recipes Sort Order Selecting the Sort Order option from the Options menu displays a selection box which allows you to select the sort order to be used for recipe lists and searching in SUDS. The options are by recipe categore (ie Pale Ale) or alphabetic by recipe name. To select an option, click on the radio button with the mouse or press the up and down arrows when the selection box is highlighted. i Pressing the OK button will save your change and pressing the Cancel button will ignore your selection. Pack SUDS database Selecting the Pack Database option from the Options menu will "pack" and reorganize all of the internal files used within the SUDS database. Because SUDS uses XBASE files, they can eventually become full of unused space as recipes are edited, changed and deleted. Packing the database will reclaim any unused space, optimize the indexes used by the system and save space on your hard disk. Export recipes to .SXF file Selecting this option from the Options menu will prompt you for a file name and will copy all of your recipes to the selected file name in a format that other users of SUDS can import into their databases. This option will display a file selection screen from which you can enter a new file to export to, or select an existing file which would be overwritten. The file you select MUST have an extension of ".SXF". & This is the easiest way to share your recipes with others. You can't simply copy your database since this would then overwrite another users database. You also have the option of saving individual recipes into text files allowing you to share single recipes with users and non-users of SUDS. Import recipes from .SXF file Selecting this option from the Options menu will allow you to import any SUDS .SXF files that you export or obtain from other SUDS users. SXF files are the easiest way to share recipes with other brewers using SUDS. This option will present a list of all .SXF files in the current directory. You may select an existing .SXF file or a directory name to navigate through other directories. ( The SXF list dialog box contains: an input box with a history list a list box to browse the directory the standard Cancel button Open action button an information panel that describes the selected file Tools (Alt-T) The Tools menu offers the following options: ` Pop-up Calculator window Pop-up Calendar window Worksheet Print labels Print Beer Labels When inside a log window in SUDS, selecting Print Beer Labels from the Tools menu will bring up the print label dialog box. This box displays a sample of the beer label, the number to be printed along with an OK and Cancel button. You can edit any of the information to be printed on the label. By default, the recipe name, bottling date, batch number, starting and finishing gravities and alchohol content will appear on the labels. SUDS uses standard mailing labels (one-up only) to print beer labels. SUDS will estimate the number of labels to print based on the recipe volume. You can override the number of labels to print. Window (Alt-W) The Window menu contains commands to close, move and perform other window-management commands. Most of the windows in this program have all the standard window elements, including scroll bars, a close box, and zoom icons. > For more about windows and their elements, refer to windows. : Window-management commands Size/Move Zoom Tile Cascade Next Previous Close Window Size/Move (Ctrl-F5) Choose this command to change the size or position of the active window. Size If you press Shift while you use the arrow keys, you can change the size of the active window. Once you've adjusted its size or position, press Enter. Q If a window has a Resize corner, you can drag that corner to resize the window. Move When you choose Window Size/Move, the active window moves in response to the arrow keys. Once you've moved the window to where you want it, press Enter. F You can also move a window by dragging its title bar with the mouse. Window Zoom (F5) Choose Zoom to resize the active window to the maximum size. If the window is already zoomed, you can choose this command to restore it to its previous size. { You can also double-click anywhere on the window's title bar (except where an icon appears) to zoom or unzoom the window. Window Tile Choose Window Tile to tile all windows on the desktop. L Tiled Windows Window Cascade Choose Window Cascade to stack all windows on the desktop. A Cascaded Windows Window Next Choose Next to cycle forwards through the windows on the desktop. Window Previous Choose Previous to cycle backwards through the windows on the desktop. Window Close (Alt-F3) Choose Close to close the active window. N You can also click the Close box in the upper left corner to close a window. Hop IBU Information Worksheet The Hop IBU worksheet allows you to enter information about the hops used in your recipe (up to 4 "hoppings") and calculates the International Bittering Units. On the worksheet you enter the quantity of the hops in ounces, the name of the hop (selecting the downarrow will display a picklist of hop names), the AAU rating of the hops (usually provided on the hop container and the time the hops were boiled in the wort. Using this information, the worksheet will calculate the hop IBUs for the batch and will fill in the Hop IBU field on the Log Window Help on Open a File Dialog Box The Open a File dialog box contains an input box, a file list, a file information panel, the standard button Cancel, one other action button (Open), plus a history list that's attached to the Name inputbox. Name The Name input box is where you enter the name of the file to load, or the file-name mask to use as a filter for the Files list box (for example, *.*). Files FILENM01.PAS FILENM09.PAS FILENM02.PAS FILENM10.PAS FILENM03.PAS FILENM11.PAS FILENM04.PAS FILENM12.PAS FILENM05.PAS .. FILENM06.PAS \MOREXAMP FILENM07.PAS \TOURS FILENM08.PAS \ANSWERS.DIR The Files list box lists the names of files in the current directory that match the file-name mask in the Name input box, plus the parent directory and all subdirectories. C:\TP\EXAMPLES\*.PAS HELLO.PAS 52 Jul 14,1990 12:00pm The File information panel shows the path name, file name, date, time, and size of the selected file. = None of the items on this information panel are selectable. [ Open ] The Open button opens a new window and places the selected recipe in that window. [ Cancel ] If you choose Cancel, nothing changes and no action occurs, and the dialog box is put away. M (Esc always cancels a dialog box, even if a Cancel button does not appear.) [ Open ] In the Open a File dialog box, if you choose the Open button SUDS opens a recipe edit window and places the selected recipe in that window. Help on the Change Directory dialog box The Change Directory dialog box consists of an input box, a list box, the standard OK and Help buttons, and two other buttons (Chdir and Revert). | Directory Name The Directory Name input box is where you type in the path of the new directory. Directory Tree Drives C:\ TP TVISION The Directory Tree list box enables you to navigate directories by using the selecting bar and pressing Enter. If you're using the keyboard, press Enter to make the selected directory be the current directory, then choose OK or press Esc to exit the dialog box. + [Chdir ] The Chdir button changes the current directory once you've selected or typed in a directory name. + [Revert] The Revert button goes back to the previous directory, as long as you haven't yet exited the dialog box. Edit Windows Edit windows are used in SUDS to enter and update recipe text and to edit and update recipe log notes. u You can open as many Edit windows as you want, but SUDS only numbers the first nine windows (of any kind) you open. l Closing and Opening Edit Windows To close an active Edit window, click the window's close box or choose Window Close. _ To open an Edit window, choose File Open. You can open the same file in more than one window. H For More Information Choose one of these for more information: 1 windows Windowing commands The SUDS Editor There are many ways to get into an open Edit window (make it active): 1) Click it. 2) Press Alt-# (where # is that Edit window's number). 3) Press (or click) F6 to cycle through the open windows. To close the active Edit window, choose Window Close. Q Once in the Edit window, you enter text just as if you were using a typewriter. P When you want to end a line, press Enter. To exit the editor, press F10. The maximum line width in an Edit window is 249 characters; you'll get a beep if you try to type past that. See also: window Cursor Movement Commands Insert Delete Commands Block Commands Miscellaneous Commands File Commands Cursor Movement Commands Character left Ctrl-S or Left arrow Character right Ctrl-D or Right arrow Word left Ctrl-A or Ctrl-Left arrow Word right Ctrl-F or Ctrl-Right arrow Line up Ctrl-E or Up arrow Line down Ctrl-X or Down arrow Scroll up Ctrl-W Scroll down Ctrl-Z Page up Ctrl-R or PgUp Page down Ctrl-C or PgDn Insert & Delete Commands Insert mode on/off Ctrl-V or Ins Insert line Ctrl-N Delete line Ctrl-Y Delete to end of line Ctrl-Q Y Delete character left Ctrl-H or Backspace Delete character Ctrl-G or Del Delete word right Ctrl-T Block Commands Using mouse - Using the mouse, a block is marked by simply holding down the left mouse button and dragging over the area to be marked. > Using keyboard Mark block begin Ctrl-K B Mark block end Ctrl-K K Mark single word Ctrl-K T Copy block Ctrl-Ins Cut block Shift-Del Delete block Ctrl-Del Hide/display block Ctrl-K H Miscellaneous Editor Commands Menu bar Close active window Alt-F3 Tab Ctrl-I or Tab Tab mode Ctrl-O T Find Ctrl-Q F Find & replace Ctrl-Q A Repeat last find Ctrl-L Abort operation